This looks safe in terms of CHM. For PDF, paged rendering of large tables will almost certainly look really bad. My controversial take is -- do we even need it at all? We already have a nice ToC, now properly and predictably ordered.

This looks safe in terms of CHM. For PDF, paged rendering of large tables will almost certainly look really bad. My controversial take is -- do we even need it at all? We already have a nice ToC, now properly and predictably ordered.

It maintains consistency between sections (not the primary reason, but good to have) and includes information that is not in the ToC. As it does not mess up the CHM I would like it to go ahead. However, your comment about the PDF is very valid. We could hold off on this until Dyalog v21.0 when that issue will resolve itself. Leave it with me.

@abrudz – after implementing feedback please do not merge this in but wait until I confirm. Thanks.